Skip to main content

OAuth 2.0 Authentication Endpoints

This document describes the OAuth 2.0 authentication flow and available endpoints for integrating with our authorization server.

🔐 OAuth 2.0 Flow Overview

  1. Redirect the user to the Authorization Endpoint.
  2. The user logs in and grants permission.
  3. The server redirects back with a code.
  4. Your app exchanges the code at the Token Endpoint for an access token.
  5. Use the access token to call protected resources.

📍 Authorization Endpoint

URL: https://auth.example.com/oauth/authorize

Method: GET

Query Parameters:

ParameterRequiredDescription
response_typeYesMust be code
client_idYesYour client ID issued by our system
redirect_uriYesWhere to redirect after authorization
scopeOptionalRequested scopes (e.g., read write)
stateOptionalAny value to maintain app state

Example URL:

https://auth.example.com/oauth/authorize?response_type=code&client_id=abc123&redirect_uri=https://yourapp.com/callback&scope=read+write&state=xyz